Obtains the number of existing references to a window.

OSStatus GetWindowOwnerCount (
    WindowRef window, 
    UInt32 *outCount
);

window

A pointer to the window whose reference (owner) count is to be determined.

outCount

A pointer to a value that, on return, contains the current number of references to the window.

function result

A result code.

DISCUSSION

With the Mac OS 8.5 Window Manager, all windows are created with a reference count (owner count) of one. The function CloneWindow increments the number of references to a window, and the earlier function DisposeWindow decrements the number of references. When the reference count reaches zero, DisposeWindow disposes of the window.

VERSION NOTES

This function is available with Mac OS 8.5 and later.

AVAILABILITY

Supported in Carbon. Available in CarbonLib 1.0 and later when WindowsLib 8.5 or later is installed. Exported by CarbonLib 1.0 and later and by WindowsLib 8.5 and later.

© 2000 Apple Computer, Inc. — (Last Updated 4/14/2000)